From f5a2ab38f3b4cda98de10cbd7f574697b0013b58 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sun, 6 May 2018 21:21:43 -0400 Subject: [PATCH] Miscellaneous docs improvements Just the usual pre-release doc fixups. --- gtk/gtksnapshot.c | 8 ++++---- gtk/gtkwidgetpaintable.c | 19 +++++++++---------- 2 files changed, 13 insertions(+), 14 deletions(-) diff --git a/gtk/gtksnapshot.c b/gtk/gtksnapshot.c index 4d367948e9..6418aefd0f 100644 --- a/gtk/gtksnapshot.c +++ b/gtk/gtksnapshot.c @@ -44,11 +44,11 @@ * a cairo context, and maintains a stack of render nodes and their associated * transformations. * - * The node at the top of the stack is the the one that gtk_snapshot_append() - * operates on. Use the gtk_snapshot_push() and gtk_snapshot_pop() functions to - * change the current node. + * The node at the top of the stack is the the one that gtk_snapshot_append_… + * functions operate on. Use the gtk_snapshot_push_… functions and gtk_snapshot_pop() + * to change the current node. * - * The typical way to obtain a #GtkSnapshot object is as an argument to + * The typical way to obtain a GtkSnapshot object is as an argument to * the #GtkWidget::snapshot vfunc. If you need to create your own GtkSnapshot, * use gtk_snapshot_new(). */ diff --git a/gtk/gtkwidgetpaintable.c b/gtk/gtkwidgetpaintable.c index d15b1cee4b..5cae0afd44 100644 --- a/gtk/gtkwidgetpaintable.c +++ b/gtk/gtkwidgetpaintable.c @@ -31,26 +31,25 @@ * @Title: GtkWidgetPaintable * @see_also: #GtkWidget, #GdkPaintable * - * #GtkWidgetPaintable is an implementation of the #GdkPaintable interface + * GtkWidgetPaintable is an implementation of the #GdkPaintable interface * that allows displaying the contents of a #GtkWidget. * - * #GtkWidgetPaintable will also take care of the widget not being in a + * GtkWidgetPaintable will also take care of the widget not being in a * state where it can be drawn (like when it isn't shown) and just draw * nothing or where it does not have a size (like when it is hidden) and * report no size in that case. * - * Of course, #GtkWidgetPaintable allows you to monitor widgets for size - * changes by emitting the GdkPaintable::invalidate-size signal whenever + * Of course, GtkWidgetPaintable allows you to monitor widgets for size + * changes by emitting the #GdkPaintable::invalidate-size signal whenever * the size of the widget changes as well as for visual changes by - * emitting the GdkPaintable::invalidate-contents signal whenever the + * emitting the #GdkPaintable::invalidate-contents signal whenever the * widget changes. * - * You can of course use a #GtkWidgetPaintable everywhere a + * You can of course use a GtkWidgetPaintable everywhere a * #GdkPaintable is allowed, including using it on a #GtkImage (or one - * of its parents) that it was set on itself via - * gtk_image_set_from_paintable(). The paintable will take care of recursion - * when this happens. - * If you do this however, make sure to set the GtkImage:can-shrink property + * of its parents) that it was set on itself via gtk_image_set_from_paintable(). + * The paintable will take care of recursion when this happens. If you do + * this however, make sure to set the #GtkImage:can-shrink property * to %TRUE or you might end up with an infinitely growing image. */ struct _GtkWidgetPaintable -- 2.30.2